MV_GIGE_SetNetTransMode

MV_GIGE_SetNetTransMode

Set SDK internal priority network mode.

API Definition

int MV_GIGE_SetNetTransMode(
  void            *handle,
  unsigned int    nType
);

Parameters

handle

[IN] Device handle, which is returned by MV_CC_CreateHandle or MV_CC_CreateHandleWithoutLog.

nType

[IN] Network mode, see the details below:

Macro Definition

Value

Description

MV_NET_TRANS_DRIVER

0x00000001

Drive mode

MV_NET_TRANS_SOCKET

0x00000002

Socket mode

Return Value

Return MV_OK(0) on success, and return Error Code on failure.

Remarks

The internal priority network mode is "drive mode" by default, and supported only by GigEVision camera.

The following sample code is for reference only.

#include "MvCameraControl.h"

void main()
{
    int nRet = -1;
    void* m_handle = NULL;

    //Enumerate all devices corresponding to specified transport protocol within subnet
    unsigned int nTLayerType = MV_GIGE_DEVICE | MV_USB_DEVICE;
    MV_CC_DEVICE_INFO_LIST m_stDevList = {0};
    int nRet = MV_CC_EnumDevices(nTLayerType, &m_stDevList);
    if (MV_OK != nRet)
    {
        printf("error: EnumDevices fail [%x]\n", nRet);
        return;
    }

    int i = 0;
    if (m_stDevList.nDeviceNum == 0)
    {
        printf("no camera found!\n");
        return;
    }

    //Select the first found online device and create device handle
    int nDeviceIndex = 0;

    MV_CC_DEVICE_INFO m_stDevInfo = {0};
    memcpy(&m_stDevInfo, m_stDevList.pDeviceInfo[nDeviceIndex], sizeof(MV_CC_DEVICE_INFO));

    nRet = MV_CC_CreateHandle(&m_handle, &m_stDevInfo);

    if (MV_OK != nRet)
    {
        printf("error: CreateHandle fail [%x]\n", nRet);
        return;
    }

    //Connect device
    unsigned int nAccessMode = MV_ACCESS_Exclusive;
    unsigned short nSwitchoverKey = 0;
      
    nRet = MV_CC_OpenDevice(m_handle, nAccessMode, nSwitchoverKey);
    if (MV_OK != nRet)
    {
        printf("error: OpenDevice fail [%x]\n", nRet);
        return;
    }

    //Set priority network mode
    unsigned int nType = MV_NET_TRANS_SOCKET; //Socket mode
    nRet = MV_GIGE_SetNetTransMode(m_handle, nType);
    if (MV_OK != nRet)
    {
        printf("error: SetNetTransMode fail [%x]\n", nRet);
        return;
    } 

    //...other processing

    //Destroy handle and release resource
    nRet = MV_CC_DestroyHandle(m_handle);
    if (MV_OK != nRet)
    {
        printf("error: DestroyHandle fail [%x]\n", nRet);
        return;
    }
}

MV_GIGE_SetNetTransMode

Set SDK internal priority network mode.

API Definition

int MV_GIGE_SetNetTransMode(
  void            *handle,
  unsigned int    nType
);

Parameters

handle

[IN] Device handle, which is returned by MV_CC_CreateHandle or MV_CC_CreateHandleWithoutLog.

nType

[IN] Network mode, see the details below:

Macro Definition

Value

Description

MV_NET_TRANS_DRIVER

0x00000001

Drive mode

MV_NET_TRANS_SOCKET

0x00000002

Socket mode

Return Value

Return MV_OK(0) on success, and return Error Code on failure.

Remarks

The internal priority network mode is "drive mode" by default, and supported only by GigEVision camera.

The following sample code is for reference only.

#include "MvCameraControl.h"

void main()
{
    int nRet = -1;
    void* m_handle = NULL;

    //Enumerate all devices corresponding to specified transport protocol within subnet
    unsigned int nTLayerType = MV_GIGE_DEVICE | MV_USB_DEVICE;
    MV_CC_DEVICE_INFO_LIST m_stDevList = {0};
    int nRet = MV_CC_EnumDevices(nTLayerType, &m_stDevList);
    if (MV_OK != nRet)
    {
        printf("error: EnumDevices fail [%x]\n", nRet);
        return;
    }

    int i = 0;
    if (m_stDevList.nDeviceNum == 0)
    {
        printf("no camera found!\n");
        return;
    }

    //Select the first found online device and create device handle
    int nDeviceIndex = 0;

    MV_CC_DEVICE_INFO m_stDevInfo = {0};
    memcpy(&m_stDevInfo, m_stDevList.pDeviceInfo[nDeviceIndex], sizeof(MV_CC_DEVICE_INFO));

    nRet = MV_CC_CreateHandle(&m_handle, &m_stDevInfo);

    if (MV_OK != nRet)
    {
        printf("error: CreateHandle fail [%x]\n", nRet);
        return;
    }

    //Connect device
    unsigned int nAccessMode = MV_ACCESS_Exclusive;
    unsigned short nSwitchoverKey = 0;
      
    nRet = MV_CC_OpenDevice(m_handle, nAccessMode, nSwitchoverKey);
    if (MV_OK != nRet)
    {
        printf("error: OpenDevice fail [%x]\n", nRet);
        return;
    }

    //Set priority network mode
    unsigned int nType = MV_NET_TRANS_SOCKET; //Socket mode
    nRet = MV_GIGE_SetNetTransMode(m_handle, nType);
    if (MV_OK != nRet)
    {
        printf("error: SetNetTransMode fail [%x]\n", nRet);
        return;
    } 

    //...other processing

    //Destroy handle and release resource
    nRet = MV_CC_DestroyHandle(m_handle);
    if (MV_OK != nRet)
    {
        printf("error: DestroyHandle fail [%x]\n", nRet);
        return;
    }
}